<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>clip_region_rel [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_regions.html">区域</a> / <a href="toc_regions_transformations.html">变换</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">clip_region_rel</span><span data-if="c" style="display:none;">clip_region_rel</span><span data-if="cpp" style="display:none;">ClipRegionRel</span><span data-if="dotnet" style="display:none;">ClipRegionRel</span><span data-if="python" style="display:none;">clip_region_rel</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">clip_region_rel</span><span data-if="c" style="display:none;">clip_region_rel</span><span data-if="cpp" style="display:none;">ClipRegionRel</span><span data-if="dotnet" style="display:none;">ClipRegionRel</span><span data-if="python" style="display:none;">clip_region_rel</span></code> — Clip a region relative to its smallest surrounding rectangle.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>clip_region_rel</b>(<a href="#Region"><i>区域</i></a> : <a href="#RegionClipped"><i>RegionClipped</i></a> : <a href="#Top"><i>Top</i></a>, <a href="#Bottom"><i>Bottom</i></a>, <a href="#Left"><i>Left</i></a>, <a href="#Right"><i>Right</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>clip_region_rel</b>(const Hobject <a href="#Region"><i>区域</i></a>, Hobject* <a href="#RegionClipped"><i>RegionClipped</i></a>, const Hlong <a href="#Top"><i>Top</i></a>, const Hlong <a href="#Bottom"><i>Bottom</i></a>, const Hlong <a href="#Left"><i>Left</i></a>, const Hlong <a href="#Right"><i>Right</i></a>)</code></p>
<p>
<code>Herror <b>T_clip_region_rel</b>(const Hobject <a href="#Region"><i>区域</i></a>, Hobject* <a href="#RegionClipped"><i>RegionClipped</i></a>, const Htuple <a href="#Top"><i>Top</i></a>, const Htuple <a href="#Bottom"><i>Bottom</i></a>, const Htuple <a href="#Left"><i>Left</i></a>, const Htuple <a href="#Right"><i>Right</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ClipRegionRel</b>(const HObject&amp; <a href="#Region"><i>区域</i></a>, HObject* <a href="#RegionClipped"><i>RegionClipped</i></a>, const HTuple&amp; <a href="#Top"><i>Top</i></a>, const HTuple&amp; <a href="#Bottom"><i>Bottom</i></a>, const HTuple&amp; <a href="#Left"><i>Left</i></a>, const HTuple&amp; <a href="#Right"><i>Right</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>::<b>ClipRegionRel</b>(Hlong <a href="#Top"><i>Top</i></a>, Hlong <a href="#Bottom"><i>Bottom</i></a>, Hlong <a href="#Left"><i>Left</i></a>, Hlong <a href="#Right"><i>Right</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ClipRegionRel</b>(<a href="HObject.html">HObject</a> <a href="#Region"><i>区域</i></a>, out <a href="HObject.html">HObject</a> <a href="#RegionClipped"><i>regionClipped</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Top"><i>top</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Bottom"><i>bottom</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Left"><i>left</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Right"><i>right</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>.<b>ClipRegionRel</b>(int <a href="#Top"><i>top</i></a>, int <a href="#Bottom"><i>bottom</i></a>, int <a href="#Left"><i>left</i></a>, int <a href="#Right"><i>right</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>clip_region_rel</b>(<a href="#Region"><i>区域</i></a>: HObject, <a href="#Top"><i>top</i></a>: int, <a href="#Bottom"><i>bottom</i></a>: int, <a href="#Left"><i>left</i></a>: int, <a href="#Right"><i>right</i></a>: int) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">clip_region_rel</span><span data-if="c" style="display:none">clip_region_rel</span><span data-if="cpp" style="display:none">ClipRegionRel</span><span data-if="com" style="display:none">ClipRegionRel</span><span data-if="dotnet" style="display:none">ClipRegionRel</span><span data-if="python" style="display:none">clip_region_rel</span></code> reduces the <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a> by eliminating
parts close to the smallest surrounding rectangle of the
<a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a>. Specifically this means that the <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a> is
clipped to a rectangle that is smaller than or equal to the smallest
surrounding rectangle. The resulting clipped region is returned in
<a href="#RegionClipped"><i><code><span data-if="hdevelop" style="display:inline">RegionClipped</span><span data-if="c" style="display:none">RegionClipped</span><span data-if="cpp" style="display:none">RegionClipped</span><span data-if="com" style="display:none">RegionClipped</span><span data-if="dotnet" style="display:none">regionClipped</span><span data-if="python" style="display:none">region_clipped</span></code></i></a>.
</p>
<p>The rectangle to which the <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a> is clipped is determined by
reducing the smallest surrounding axis-parallel rectangle at the top,
bottom, left, and right side by the values given in <a href="#Top"><i><code><span data-if="hdevelop" style="display:inline">Top</span><span data-if="c" style="display:none">Top</span><span data-if="cpp" style="display:none">Top</span><span data-if="com" style="display:none">Top</span><span data-if="dotnet" style="display:none">top</span><span data-if="python" style="display:none">top</span></code></i></a>,
<a href="#Bottom"><i><code><span data-if="hdevelop" style="display:inline">Bottom</span><span data-if="c" style="display:none">Bottom</span><span data-if="cpp" style="display:none">Bottom</span><span data-if="com" style="display:none">Bottom</span><span data-if="dotnet" style="display:none">bottom</span><span data-if="python" style="display:none">bottom</span></code></i></a>, <a href="#Left"><i><code><span data-if="hdevelop" style="display:inline">Left</span><span data-if="c" style="display:none">Left</span><span data-if="cpp" style="display:none">Left</span><span data-if="com" style="display:none">Left</span><span data-if="dotnet" style="display:none">left</span><span data-if="python" style="display:none">left</span></code></i></a>, and <a href="#Right"><i><code><span data-if="hdevelop" style="display:inline">Right</span><span data-if="c" style="display:none">Right</span><span data-if="cpp" style="display:none">Right</span><span data-if="com" style="display:none">Right</span><span data-if="dotnet" style="display:none">right</span><span data-if="python" style="display:none">right</span></code></i></a>, respectively.
</p>
<div style="text-align:center;" class="figure">
<table style="margin-left:auto;margin-right:auto">
<tr>
<td><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="205pt" height="126pt" viewBox="99 709 3820 2343">
<g fill="none">

<image xlink:href=" AAAuIwAALiMBeKU/dgAAAAd0SU1FB90HHQkvKrRRPDcAAAFLSURBVGiB7ZnRDsIwCEWZ8b8bvlwf lhgzgVK4dI3pfTJm8ewArbMeL5qex3zkZm7mZm7mZm7mZm7mRCYTEzMbVxywZzCB0rhJVz4RtKZY KW/nPK0KnpFEw559nJrQDDGZM9LLeG3V7gkRR8jpyfRZA5yp6hnbk1uGIFt2ZyjtNMxMETVLi1mi SESFe7yuqXvmNA2i7lmI1DyLpsdkxljyV9dP5D3Bq+ljXJPxjBEzzCgxsT7jyKBnAkiKZ922R0Qx z5xlqJ9ZZICZRt7y22G0n3nLYU8EcpAJQQ7VFkMc8kQhB5gwpJ+JQ8pM4Oe7mUKQtyEza0WdntCb UJilov9xPhRnVhZ3Jc9LoE9lKrOwuN7aIkXX6ueluEDRtTyvwYkazLLJtTyrOrpcP4uqe4dn78z4 q4nTnm+b8Cobx9k4Y4nI/3T8WW6t/BHzDbc6Na0zzEQWAAAAAElFTkSuQmCC " preserveAspectRatio="none" x="99" y="709" width="3286" height="2343"></image>

<text xml:space="preserve" x="2905" y="3007" fill="#000000" font-family="Helvetica" font-style="normal" font-weight="normal" font-size="144" text-anchor="start">Bottom = 0</text>

<polyline points=" 697,1577 2800,1577" stroke="#000000" stroke-width="8px" stroke-dasharray="40 40"></polyline>

<polyline points=" 2230,1292 2230,2925" stroke="#000000" stroke-width="8px" stroke-dasharray="40 40"></polyline>

<rect x="687" y="1296" width="2112" height="1628" stroke="#000000" stroke-width="8px"></rect>

<polyline points=" 970,1292 970,2925" stroke="#000000" stroke-width="8px" stroke-dasharray="40 40"></polyline>

<text xml:space="preserve" x="2875" y="1522" fill="#000000" font-family="Helvetica" font-style="normal" font-weight="normal" font-size="144" text-anchor="start">Top = 10</text>

<text xml:space="preserve" x="2085" y="1122" fill="#000000" font-family="Helvetica" font-style="normal" font-weight="normal" font-size="144" text-anchor="start">Right = 20</text>

<text xml:space="preserve" x="570" y="1132" fill="#000000" font-family="Helvetica" font-style="normal" font-weight="normal" font-size="144" text-anchor="start">Left = 10</text>

<text xml:space="preserve" x="1050" y="1927" fill="#000000" font-family="Helvetica" font-style="normal" font-weight="normal" font-size="144" text-anchor="start">区域</text>
</g>
</svg></td>
<td><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="176pt" height="126pt" viewBox="3983 709 3286 2343">
<g fill="none">

<image xlink:href=" AAAuIwAALiMBeKU/dgAAAAd0SU1FB90HHQkvKrRRPDcAAADCSURBVGiB7drLCoMwFEVRLf63+OV1 2onNfezKMT0ZCYqLnURQcH0vt4/X/aRNmzZt2rRp06ZNmzZtyprb99NH5l578Lp/mVubc5mDZ2Uw ok8HZ9bEjlkVG+tZJ4udDXB5zr7tVZY6u2TBbJOPWM9+ZbqTIJMmQqbmlhFTnRSZMDEybnKk9LsJ mKncSWYqd9qcy0x9+0ImOqImGarcSYZKd4Kh2p1cqHjnzOZ+cfxL8wPiXk/W8T8uByuGTHwI7qFp zBN0QhKfLbZvPwAAAABJRU5ErkJggg== " preserveAspectRatio="none" x="3983" y="709" width="3286" height="2343"></image>

<polyline points=" 4581,1577 6684,1577" stroke="#000000" stroke-width="8px" stroke-dasharray="40 40"></polyline>

<polyline points=" 6114,1292 6114,2925" stroke="#000000" stroke-width="8px" stroke-dasharray="40 40"></polyline>

<polyline points=" 4854,1292 4854,2925" stroke="#000000" stroke-width="8px" stroke-dasharray="40 40"></polyline>

<rect x="4571" y="1296" width="2112" height="1628" stroke="#000000" stroke-width="8px"></rect>

<text xml:space="preserve" x="4949" y="1927" fill="#000000" font-family="Helvetica" font-style="normal" font-weight="normal" font-size="144" text-anchor="start">RegionClipped</text>
</g>
</svg></td>
</tr>
<tr>
<td align="center">
        (
      1)
    </td>
<td align="center">
        (
      2)
    </td>
</tr>
</table>
<div style="margin-bottom:30px;text-align:center;" class="caption">
Region with smallest surrounding rectangle (1) and clipped region (2).
</div>
</div>
<p>These four parameters must contain numbers larger or equal to zero. If
all parameters are set to zero, the region remains unchanged.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Region" class="parname"><b><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></b> (input_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Regions to be clipped.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="RegionClipped" class="parname"><b><code><span data-if="hdevelop" style="display:inline">RegionClipped</span><span data-if="c" style="display:none">RegionClipped</span><span data-if="cpp" style="display:none">RegionClipped</span><span data-if="com" style="display:none">RegionClipped</span><span data-if="dotnet" style="display:none">regionClipped</span><span data-if="python" style="display:none">region_clipped</span></code></b> (output_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject *</span></span>
</div>
<p class="pardesc">Clipped regions.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Top" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Top</span><span data-if="c" style="display:none">Top</span><span data-if="cpp" style="display:none">Top</span><span data-if="com" style="display:none">Top</span><span data-if="dotnet" style="display:none">top</span><span data-if="python" style="display:none">top</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of rows clipped at the top.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Top</span>
    <span data-if="c" style="display:none">Top</span>
    <span data-if="cpp" style="display:none">Top</span>
    <span data-if="com" style="display:none">Top</span>
    <span data-if="dotnet" style="display:none">top</span>
    <span data-if="python" style="display:none">top</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Bottom" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Bottom</span><span data-if="c" style="display:none">Bottom</span><span data-if="cpp" style="display:none">Bottom</span><span data-if="com" style="display:none">Bottom</span><span data-if="dotnet" style="display:none">bottom</span><span data-if="python" style="display:none">bottom</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of rows clipped at the bottom.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Bottom</span>
    <span data-if="c" style="display:none">Bottom</span>
    <span data-if="cpp" style="display:none">Bottom</span>
    <span data-if="com" style="display:none">Bottom</span>
    <span data-if="dotnet" style="display:none">bottom</span>
    <span data-if="python" style="display:none">bottom</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Left" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Left</span><span data-if="c" style="display:none">Left</span><span data-if="cpp" style="display:none">Left</span><span data-if="com" style="display:none">Left</span><span data-if="dotnet" style="display:none">left</span><span data-if="python" style="display:none">left</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of columns clipped at the left.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Left</span>
    <span data-if="c" style="display:none">Left</span>
    <span data-if="cpp" style="display:none">Left</span>
    <span data-if="com" style="display:none">Left</span>
    <span data-if="dotnet" style="display:none">left</span>
    <span data-if="python" style="display:none">left</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Right" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Right</span><span data-if="c" style="display:none">Right</span><span data-if="cpp" style="display:none">Right</span><span data-if="com" style="display:none">Right</span><span data-if="dotnet" style="display:none">right</span><span data-if="python" style="display:none">right</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of columns clipped at the right.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Right</span>
    <span data-if="c" style="display:none">Right</span>
    <span data-if="cpp" style="display:none">Right</span>
    <span data-if="com" style="display:none">Right</span>
    <span data-if="dotnet" style="display:none">right</span>
    <span data-if="python" style="display:none">right</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">clip_region_rel</span><span data-if="c" style="display:none">clip_region_rel</span><span data-if="cpp" style="display:none">ClipRegionRel</span><span data-if="com" style="display:none">ClipRegionRel</span><span data-if="dotnet" style="display:none">ClipRegionRel</span><span data-if="python" style="display:none">clip_region_rel</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters are
correct.  The behavior in case of empty input (no regions given) can
be set via <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('no_object_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>
and the behavior in case of an empty input region via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('empty_region_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("empty_region_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("empty_region_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("empty_region_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("empty_region_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("empty_region_result",&lt;Result&gt;)</span></code></a>.
如有必要，将引发异常。</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>, 
<code><a href="connection.html"><span data-if="hdevelop" style="display:inline">connection</span><span data-if="c" style="display:none">connection</span><span data-if="cpp" style="display:none">Connection</span><span data-if="com" style="display:none">Connection</span><span data-if="dotnet" style="display:none">Connection</span><span data-if="python" style="display:none">connection</span></a></code>, 
<code><a href="regiongrowing.html"><span data-if="hdevelop" style="display:inline">regiongrowing</span><span data-if="c" style="display:none">regiongrowing</span><span data-if="cpp" style="display:none">Regiongrowing</span><span data-if="com" style="display:none">Regiongrowing</span><span data-if="dotnet" style="display:none">Regiongrowing</span><span data-if="python" style="display:none">regiongrowing</span></a></code>, 
<code><a href="pouring.html"><span data-if="hdevelop" style="display:inline">pouring</span><span data-if="c" style="display:none">pouring</span><span data-if="cpp" style="display:none">Pouring</span><span data-if="com" style="display:none">Pouring</span><span data-if="dotnet" style="display:none">Pouring</span><span data-if="python" style="display:none">pouring</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="select_shape.html"><span data-if="hdevelop" style="display:inline">select_shape</span><span data-if="c" style="display:none">select_shape</span><span data-if="cpp" style="display:none">SelectShape</span><span data-if="com" style="display:none">SelectShape</span><span data-if="dotnet" style="display:none">SelectShape</span><span data-if="python" style="display:none">select_shape</span></a></code>, 
<code><a href="disp_region.html"><span data-if="hdevelop" style="display:inline">disp_region</span><span data-if="c" style="display:none">disp_region</span><span data-if="cpp" style="display:none">DispRegion</span><span data-if="com" style="display:none">DispRegion</span><span data-if="dotnet" style="display:none">DispRegion</span><span data-if="python" style="display:none">disp_region</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="smallest_rectangle1.html"><span data-if="hdevelop" style="display:inline">smallest_rectangle1</span><span data-if="c" style="display:none">smallest_rectangle1</span><span data-if="cpp" style="display:none">SmallestRectangle1</span><span data-if="com" style="display:none">SmallestRectangle1</span><span data-if="dotnet" style="display:none">SmallestRectangle1</span><span data-if="python" style="display:none">smallest_rectangle1</span></a></code>, 
<code><a href="intersection.html"><span data-if="hdevelop" style="display:inline">intersection</span><span data-if="c" style="display:none">intersection</span><span data-if="cpp" style="display:none">Intersection</span><span data-if="com" style="display:none">Intersection</span><span data-if="dotnet" style="display:none">Intersection</span><span data-if="python" style="display:none">intersection</span></a></code>, 
<code><a href="gen_rectangle1.html"><span data-if="hdevelop" style="display:inline">gen_rectangle1</span><span data-if="c" style="display:none">gen_rectangle1</span><span data-if="cpp" style="display:none">GenRectangle1</span><span data-if="com" style="display:none">GenRectangle1</span><span data-if="dotnet" style="display:none">GenRectangle1</span><span data-if="python" style="display:none">gen_rectangle1</span></a></code>, 
<code><a href="clip_region.html"><span data-if="hdevelop" style="display:inline">clip_region</span><span data-if="c" style="display:none">clip_region</span><span data-if="cpp" style="display:none">ClipRegion</span><span data-if="com" style="display:none">ClipRegion</span><span data-if="dotnet" style="display:none">ClipRegion</span><span data-if="python" style="display:none">clip_region</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
